home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / emula / arosdv19.lha / AROS / intuition / getattr.c < prev    next >
C/C++ Source or Header  |  1996-11-08  |  2KB  |  91 lines
  1. /*
  2.     (C) 1995-96 AROS - The Amiga Replacement OS
  3.     $Id: getattr.c,v 1.3 1996/11/08 11:28:02 aros Exp $
  4.     $Log: getattr.c,v $
  5.     Revision 1.3  1996/11/08 11:28:02  aros
  6.     All OS function use now Amiga types
  7.  
  8.     Moved intuition-driver protos to intuition_intern.h
  9.  
  10.     Revision 1.2  1996/10/24 15:51:19  aros
  11.     Use the official AROS macros over the __AROS versions.
  12.  
  13.     Revision 1.1  1996/08/28 17:55:34  digulla
  14.     Proportional gadgets
  15.     BOOPSI
  16.  
  17.  
  18.     Desc:
  19.     Lang: english
  20. */
  21. #include <clib/alib_protos.h>
  22. #include "intuition_intern.h"
  23.  
  24. /*****************************************************************************
  25.  
  26.     NAME */
  27.     #include <intuition/classusr.h>
  28.     #include <clib/intuition_protos.h>
  29.  
  30.     AROS_LH3(ULONG, GetAttr,
  31.  
  32. /*  SYNOPSIS */
  33.     AROS_LHA(ULONG   , attrID, D0),
  34.     AROS_LHA(Object *, object, A0),
  35.     AROS_LHA(IPTR *  , storagePtr, A1),
  36.  
  37. /*  LOCATION */
  38.     struct IntuitionBase *, IntuitionBase, 109, Intuition)
  39.  
  40. /*  FUNCTION
  41.     Asks the specified object for the value of an attribute. This is not
  42.     possible for all attributes of an object. Read the documentation for
  43.     the class to find out which can be read and which can't.
  44.  
  45.     INPUTS
  46.     attrID - ID of the attribute you want
  47.     object - Ask the attribute from this object
  48.     storagePtr - This is a pointer to memory which is large enough
  49.         to hold a copy of the attribute. Most classes will simply
  50.         put a copy of the value stored in the object here but this
  51.         behaviour is class specific. Therefore read the instructions
  52.         in the class description carefully.
  53.  
  54.     RESULT
  55.     Mostly TRUE if the method is supported for the specified attribute
  56.     and FALSE if it isn't or the attribute can't be read at this time.
  57.     See the classes documentation for details.
  58.  
  59.     NOTES
  60.     This function sends OM_GET to the object.
  61.  
  62.     EXAMPLE
  63.  
  64.     BUGS
  65.  
  66.     SEE ALSO
  67.     NewObject(), DisposeObject(), SetAttr(), MakeClass(),
  68.     "Basic Object-Oriented Programming System for Intuition" and
  69.     "boopsi Class Reference" Dokument.
  70.  
  71.  
  72.     INTERNALS
  73.  
  74.     HISTORY
  75.     29-10-95    digulla automatically created from
  76.                 intuition_lib.fd and clib/intuition_protos.h
  77.  
  78. *****************************************************************************/
  79. {
  80.     AROS_LIBFUNC_INIT
  81.     AROS_LIBBASE_EXT_DECL(struct IntuitionBase *,IntuitionBase)
  82.     struct opGet get;
  83.  
  84.     get.MethodID    = OM_GET;
  85.     get.opg_AttrID  = attrID;
  86.     get.opg_Storage = storagePtr;
  87.  
  88.     return (DoMethodA (object, (Msg)&get));
  89.     AROS_LIBFUNC_EXIT
  90. } /* GetAttr */
  91.